home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 4 / Apprentice-Release4.iso / Source Code / C / Code Resources / Jims CDEFs 1.50 / Documents / About cdef3D < prev    next >
Encoding:
Text File  |  1995-10-27  |  2.3 KB  |  61 lines  |  [TEXT/KAHL]
  1. Jim's CDEFs © 1994-1995 by James G. Stout
  2. --------------------------------------------------------------------
  3. About cdef3D…
  4.  
  5. Note: v1.5 of this control is again a major update.  I reworked the "anti-
  6. flicker" logic by using GWorlds and added a 'tingeColor' option.
  7.  
  8. v1.4 was also a major change to this control.  v1.2 fixed some multiple 
  9. monitor problems, v1.3 is a minor cleanup and the source is now with the 
  10. source for the other CDEFs.  You can use this as a guide for working with 
  11. and debugging the other controls.
  12.  
  13. This started life as a pretty "bare bones" CDEF.  It is now a "proper"
  14. 3D replacement for the default CDEF 0 (which supplies the Mac with its
  15. pushButtons, radioButtons and checkBoxes).
  16.     
  17. This control is a similar to the the standard "2D' black & white buttons, 
  18. but with some subtle gray shading to give what (IMHO) is a pleasing 3D 
  19. effect. See develop issue 15 for a good article about "Working in the 
  20. third dimension" and 3D controls.
  21.  
  22. An addition is variation code 4 - in this control it forces the push button
  23. variation to use the background color from the current port.
  24. ** NOTE **
  25.     Variation 4 was used for a "Tog Button" in earlier versions of this
  26.     CDEF.  There is now a separate control for a "Tog Button".
  27.         
  28. It will behave properly in color environments, respecting 'cctb' resources and
  29. using the System 7 style gray for disabled controls.
  30.  
  31. 3 Think C projects are included:
  32.  
  33. debugCDEF π
  34.     - builds a 'dummy' code resource (CDEF id=128) for use in debugging.
  35.     - you don't need to build this, the dummy CDEF is in the debug.rsrc file.
  36.     
  37. test3D π
  38.     - run the CDEF 128 as inline code to test it.
  39.     
  40. The CDEF code is contained in file cdef3D.c
  41.  
  42. There are several utility routines here that could be used in any CDEF project.
  43.  
  44. colorCDEF.c / colorCDEF.h    - get 'cctb' colors 
  45. grayCDEF.c / grayCDEF.h        - for disabled gray text
  46. miscCDEF.c / miscCDEF.h        - utility routines
  47. qdCDEF.c / qdCDEF.h            - get an offscreen drawing environment
  48.  
  49. and debugCDEF.c    - to help with source level debugging.
  50.  
  51. The code is fairly straight forward and moderately well commented.  Let me know
  52. if you need more information.
  53.  
  54. Jim Stout
  55.  
  56. Internet    : JimS@WRQ.COM(work hours, PST)
  57. AppleLink   : WRQ            (daily)
  58. CompuServe  : 73240,2052    (weekly or so)
  59. AOL         : JasG        (weekly or so)
  60. eWorld      : Jim Stout    (weekly or so)
  61.